1. Documentation
  2. Crossbill Nest docs
  3. 24.x
  4. Initial configuration

Crossbill Nest initial configuration

On the Crossbill Nest installation, the initial system configuration is required. To perform a configuration follow the steps:

Configure Crossbill Central

Crossbill Central is a web system for the software updates and license management. To perform an initial configuration follow the steps:

  1. Open a web browser.
  2. Navigate to Crossbill Central web page. By default, the page is available as http://central.my-domain.com (where my-domain.com should be replaced with the domain name configured during the installation).
  3. On the first load of the system, it is expected some wait time until the page appears. During the first start, you may see a 502 or 504 error page. In this case refresh a page in a browser until the valid page appears.
  4. The initial screen allows you to create a system administrator account. Fill the required fields and click the Create Account button.
    Central. 1.Create Admin Account

    Central. 1.Create Admin Account

  5. The next screen configures a system language. Use default value for any common configuration. To save the choice click the Save Changes button.
    Central. 2.Configure the locale

    Central. 2.Configure the locale

  6. The next screen configures the mailing component. Note that you can skip the mailing configuration on this step and do it later from a System Settings page. The system uses SMTP standard to send e-mails. The SMTP server configuration is required for any mailing tasks. Use settings from a third party mailing provider you already have or install a private SMTP server. For example, you may use Crossbill CrossMail to have a dedicated mail server suitable for mailing tasks. Once you set the settings, click the Save Changes button.
    Central. 3.Configure the e-mail notifications

    Central. 3.Configure the e-mail notifications

  7. Crossbill Central is now configured. Log into the system using the e-mail and password of the administrator's account.
    Central. 4.Sign in

    Central. 4.Sign in

Configure Crossbill Nest

Now it's time to configure the Crossbill Nest system. Follow the steps:

  1. Open a web browser. 
  2. Navigate to Crossbill Nest web page. By default, the page is available as http://nest.my-domain.com (where my-domain.com should be replaced with the domain name configured during the installation). 
  3. On the first load of the system, it is expected some wait time until the page appears. During the first start, you may see a 502 or 504 error page. In this case refresh a page in a browser until the valid page appears.
  4. If Crossbill Central is already configured, then the licensing page would appear. You can get an evaluation (trial) license for Crossbill Nest. Select a related option and click the Continue button.
    Nest. 1.Get a Trial License

    Nest. 1.Get a Trial License

  5. The next screen configures a connection to the crossbillsoftware.com website. The license information will be automatically downloaded from crossbillsoftware.com. So, the connection information is required. If you need a new account, click the Create new account link and follow the crossbillsoftware.com account registration steps.

    Note that you have an option to use an offline license file. In this case, no online connection is required.

    [Image not found!]
  6. Enter your crossbillsoftware.com account username and password. Click the Connect button.
  7. Now you can issue an evaluation (trial) license or enter the license details you already have. 
  8. To issue an evaluation (trial) license click the request evaluation license link. The link directs you to a license request page on the crossbillsoftware.com website.
    Nest. 7.Request a License

    Nest. 7.Request a License

  9. Make sure to fill the application field and a server key field properly. Then click the Request button.
  10. Once license is ready, you will see a confirmation:
    Nest. 8.Your license is ready

    Nest. 8.Your license is ready

  11. Also Crossbill sends a confirmation e-mail message. 
    Nest. 9.You order have been completed

    Nest. 9.You order have been completed

  12. Once the license is issued, the Crossbill Nest configuration continues. The next screen configures a system language. Use default value for any common configuration. To save the choice click the Save Changes button. 
    Nest. 11.Configure the locale

    Nest. 11.Configure the locale

  13. The next screen configures the installation type. The NuGet server installation allows to upload and host the NuGet packages in a way fully compatible with nuget.exe, dotnet.exe and MS Visual Studio. The marketplace server installation hides all NuGet commands and designed to be used with Crossbill Central as the application marketplace. 
    Nest. 12.How to use the system

    Nest. 12.How to use the system

  14. Crossbill Nest is now configured. Log into the system using the e-mail and password of the administrator's account. 

    Nest. 13.Sign in

    Nest. 13.Sign in

  15. You can upload an application package using the Upload button, via API or direclty to the packages directory: 
    Nest. 14. Welcome screen

    Nest. 14. Welcome screen