# NethServer

Generated on 15 Dec 2020 from [the NethServer catalog page](https://marketplace.digitalocean.com/apps/nethserver)

The all-in-one solution to:

- setup your mail server with a complete groupware in minutes
- access your mail, contacts and calendar directly from the browser using [WebTop](http://www.sonicle.com/webtop-5/?lang=en) or [Roundcube](https://roundcube.net/)
- share your files using [Nextcloud](https://nextcloud.com/)
- chat with your teammates joining [Mattermost](https://mattermost.com/)
- host your site with a complete LAMP (Linux, Apache, MariaDB, PHP) stack

Not enough? Check our list of [community modules](https://wiki.nethserver.org/doku.php?id=modules)!

## Software Included

*This Marketplace listing does not include a detailed software list.*

## Creating an App using the Control Panel

Click the **Deploy to DigitalOcean** button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

[![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/droplets/new?image=nethesis-nethserver-7)

## Creating an App using the API

In addition to creating a Droplet from the NethServer 1-Click App using the control panel, you can also use the [DigitalOcean API](https://docs.digitalocean.com/reference/api). As an example, to create a 4GB NethServer Droplet in the SFO2 region, you can use the following `curl` command. You need to either save your [API access token](https://docs.digitalocean.com/reference/api/create-personal-access-token/index.html.md) to an environment variable or substitute it in the command below.

```shell
curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"nethesis-nethserver-7"}' \
        "https://api.digitalocean.com/v2/droplets"
```

## Getting Started After Deploying NethServer

During droplet creation please choose “Password” in “Authentication” section.

NethServer can be configured using the *Server Manager* web interface.

You need a web browser like Mozilla Firefox or Google Chrome to access the web interface at port `9090` using the droplet IP address: `https://server_ip:9090`.

To access the *Server Manager* use the `root` user with the password chosen during the droplet creation phase.

If you didn’t choose a root password during droplet creation, access the system using SSH on port `22`.

You can now set a password for the `root` user to access *Server Manager*. To set the `root` password, use the `passwd` command and follow the instructions on the screen.

Finally, access the *Server Manager* and access using `root` user the chosen password.

Please note that created droplet does not have any SWAP configured. If you wish to add the SWAP see [How To Add Swap on CentOS 7](https://www.digitalocean.com/community/tutorials/how-to-add-swap-on-centos-7).

If you need help, join our great community at [https://community.nethserver.org](https://community.nethserver.org).

Looking for professional support? Check out our subscription plans at [https://my.nethserver.com](https://my.nethserver.com).