ownCloud Writing TestAndy Lewis

Installing and Using ownCloud on Docker

If you’re new to ownCloud and looking to quickly try out a small deployment, then you’ve come to the right place. In this quick start guide, we’ll take you step-by-step from installing your ownCloud server as an administrator to connecting to the server as a user.

If you’re an experienced administrator for an organization that needs to scale out to mid-sized or large enterprises, see Deployment Recommendations.

System Requirements

A machine with:

Installing and Configuring your ownCloud Server

  1. Create and run the following script.

     # Create a new project directory
     mkdir owncloud-docker-server
    
     cd owncloud-docker-server
    
     # Copy docker-compose.yml from the GitHub repository
     wget https://raw.githubusercontent.com/owncloud/docs/master/modules/admin_manual/examples/installation/docker/docker-compose.yml
    
     # Create the environment configuration file
     cat << EOF > .env
     OWNCLOUD_VERSION=10.4
     OWNCLOUD_DOMAIN=localhost
     ADMIN_USERNAME=admin
     ADMIN_PASSWORD=admin
     HTTP_PORT=8080
     EOF
    
     # Build and start the container
     docker-compose up -d
    
  2. When the script is completed, confirm that all the containers are running.

     docker-compose ps
    

    If the ownCloud server, database, and Redis containers are running, the command will return something like this:

     Name                Command                       State             Ports
     __________________________________________________________________________________________
     server_db_1         /usr/bin/entrypoint/bin/s …   Up                3306/tcp
     server_owncloud_1   /usr/local/bin/entrypoint …   Up                0.0.0.0:8080->8080/tcp
     server_redis_1      /bin/s6-svscan /etc/s6        Up                6379/tcp
    
  3. Wait a few minutes to allow the the ownCloud server to finish initializing all its capabilities. To verify if ownCloud is still initializing:

     docker-compose logs --follow owncloud
    

    If you see a significant amount of information logging to the console, then we recommend that you wait until you see the logging slow down before you try to connect to ownCloud from your Web browser.

You just installed your ownCloud server!

In your Web browser navigate to http://localhost:8080 and then log in using the admin username and password that you used above.

Q&A

Adding a User

To add a user:

  1. Go to the default view.

  2. Enter the new user’s Login Name (Username).

    Login names can contain letters (a-z, A-Z), numbers (0-9), dashes (-), underscores (_), periods (.) and at signs (@).

  3. Enter the new user’s E-Mail address.

  4. (Optional) Select the Groups in which you want the user to be a member.

  5. Click the [ Create ] button.

  6. (Optional) After you’ve created the user, you can enter their Full Name. Or, the user can do it later if they want.

Learn more

Getting your Users Connected

When you’re ready to open your ownCloud server to your users, here are the manuals to help them get started: