Directus
Directus
by Directus

VERSION 8.2.0

OS Ubuntu 18.04

Description

Directus follows a data-first approach, storing your unaltered content in pure SQL databases that can be completely customized and infinitely optimized.

The Directus Suite consists of:

  • Directus Database API — Wraps any new or existing SQL database with RESTful JSON or GraphQL endpoints for connecting content anywhere: websites, native apps, wearables, IoT devices, kiosks, or anything else!
  • Directus Admin App — An intuitive admin interface built with Vue.js that works in conjunction with our API to allow non-technical users to manage database content and digital assets.

Software Included

PackageVersionLicense
Directus8.2.0GPL 3
Apache2.4Apache 2
MySQL5.7GPL 2
PHP7.2PHP 3.01

Getting started after deploying Directus

Step One: Get Your Database Credentials

Connect to your droplet through SSH. Once connected, you will see a Directus welcome message with your database credentials at the bottom (see example below). Take note of all this information (usernames, passwords and URLs) so that you can access it later.

Note: If you set a firewall on this droplet, you will need to ensure port 22 (SSH) allows connections.

Note: Remove /var/directus/credentials.txt to stop this message from showing up.

Step Two: Finish Setup in the Directus App

Next, access your new Directus Admin App by navigating your browser to the droplet's IP address (found in your DigitalOcean Dashboard/CLI). At this point the App will guide you through the final few steps of configuration.

  1. Navigate to http://<your_droplet_ip>
  2. Enter info for your project and first Admin User
    • Project Name: Add the name of your project here
    • Project Key: Used in the URL/config, can not be changed later
    • Admin Email/Password: Credentials for your first Admin User
  3. Enter the database credentials from Step One (above)
    • Host: This will likely be localhost
    • Port: This will likely be 3306
    • Database User: This should be set to directus
    • Database User Password: This comes from the "MySQL Password" in Step One
    • Database Name: This will likely be directus

Now Directus will setup the database and take you to the Sign In page where you can login with the Admin user you added above. That's it! Now you can head to Settings and start creating your Collections and Fields. To learn more, visit: https://docs.directus.io/

Example: Droplet Intro Message

                            .cxxkkkxxdol:;'.
                            .:KMMMMMMMMMMWNKko:.
                            ,kNMMMMMMMMMWNNMMMWXOl'
                 ,l,         .;ldxkkOkdo::OMMMMMMMNk:.
                '0MNkl;'...              cNMMMMMMMMMW0c.
                .oXWMMWNXK0Okxol:'...  .cKMMMMMMMMMMMNx.
                  lNMMMMMMMMMMMMMWNX0OOKWMMMMMMNOool:'
                 .OMMMMMMMMMMMMMMMMMMMMMMMMMMMWo
                 lWMMMMMMMMMMMMMMMMMMMMMMMMMMMX;
               .lXMMMMMMMWXKXWMMMMMMMMMMMMMMMMNd;'..
            :x0XWMMMMMMNk:...,cdONWMMMMMMMMMMMMMWNX0ko;.
           :NMMMNK0Oxoc'         ';:dOKNWWMMMMMMWNXXNWWKl.
          ;KMW0c'..                   .',,;clll:,...'cOWWx.
        .lXMXo.                                       .,:'
       'ONKd'
       .''.

       Welcome to DigitalOcean's One-Click Directus Droplet!
   Here are some helpful links to get you started with Directus
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

          Directus main website: https://directus.io
         Directus documentation: https://docs.directus.io
              Your installation: http://<ip>
                     Your admin: http://<ip>/admin


    Here are some information about your current installation
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    - Directus is installed at /var/directus/
    - Your credentials are stored in ~/credentials.txt
    - UFW firewall is enabled, all ports are BLOCKED except
      22 (SSH), 80 (HTTP), 443 (HTTPS)
    - If you're unable to access the admin panel, please check
      your firewall droplet rules inside DigitalOcean's panel

        Just for quick access, these are your credentials
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

            MySQL Root Username: root
            MySQL Root Password: <root_password>

                 MySQL Database: directus
                 MySQL Username: directus
                 MySQL Password: <directus_password>

                      Admin URL: http://<ip>/admin

                         [[ IMPORTANT ]]
    To stop these credentials from showing each time you login
      you need to remove /var/directus/credentials.txt file.
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

API Creation

In addition to creating a Droplet from the Directus 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Directus Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.


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

Support Details

Hours:Monday through Friday, 10am to 5pm (ET)
Support URL:https://directus.io

More DigitalOcean Links

Product Docs

Technical overviews, how-tos, release notes, and support material

Tutorials

DevOps and development guidelines

API Docs

Run your resources programmatically

Ask a question

Connect, share and learn

arrow-down-longarrow-downIcon--arrowFilterDownIcon--arrowFilterUparrow-left-longarrow-right-longarrow-rightarrow-up-longarrow-upasterikcheckclosedownloademailerrorIcon--gearexpandfacebookIcon--geargithubgoogleinstagramlinkedinIcon--minusIcon--plusBanner-PolicyDroplet-Backup-SnapshotDropletFirewall-RuleFloating-IPLoad-BalancerSpaceproduct--tagVolume-SnapshotVolumeIcon--sammysearchshareshrinktwitterwarningIcon--waveyoutube