Keywords: Network Server security, Network Server, and security changes

# Network Server security

By default, the Derby Network Server will only listen on the localhost. Clients must use the localhost host name to connect. By default, clients cannot access the Network Server from another host. To enable connections from other hosts, set the derby.drda.host property, or start the Network Server with the `-h` option in the `java org.apache.derby.drda.NetworkServerControl start` command.

In the following example the server will listen only on localhost and clients cannot access the server from another host.

    java org.apache.derby.drda.NetworkServerControl start

In the following example, the server runs on host machine `sampleserver.sampledomain.com` and also listens for clients from other hosts. Clients must specify the server in the URL or DataSource as sampleserver.sampledomain.com:

    java org.apache.derby.drda.NetworkServerControl start
       -h sampleserver.sampledomain.com

To start the Network Server so that it will listen on all interfaces, start with an IP address of `0.0.0.0`, shown in the following example:

    java org.apache.derby.drda.NetworkServerControl start -h 0.0.0.0

A server that is started with the `-h 0.0.0.0` option will listen to client requests that originate from both `localhost` and from other machines on the network.

However, administrative commands (for example, `org.apache.derby.drda.NetworkServerControl shutdown`) can run only on the host where the server was started, even if the server was started with the `-h` option.

Parent topic: Derby Network Server advanced topics
Related concepts
Network encryption and authentication with SSL/TLS
Related tasks
Running the Network Server under the security manager
Running the Network Server with User Authentication
Configuring the Network Server to handle connections
Controlling logging by using the log file
Controlling tracing by using the trace facility