dockette/devstack repository overview

⁠DevStack

Great LAMP devstack based on Docker & Docker Compose for your home programming.

⁠Discussion / Help

⁠LAMP

• Apache 2.4.x
• PHP 7.2.x + Composer + PHPMailer
• PHP 5.6.x + Composer + PHPMailer
• NodeJS 8.x + NPM 5.x
• MariaDB 10.1
• PostgreSQL 9.6
• Adminer 4.3.x

⁠Install

1. Download devstack binary script.

   wget https://raw.githubusercontent.com/dockette/devstack/master/devstack
   wget https://raw.githubusercontent.com/dockette/devstack/master/docker-compose.yml
   

   Copy

2. Setup devstack variables in your .profile or .bashrc.

   These values are default!

   • DEVSTACK_DOCKER=~/.devstack/docker-compose.yml (docker compose file)
   • DEVSTACK_PREFIX=devstack (container's prefix)
   • DEVSTACK_USER=dfx (attached user in container) [you can leave it]

3. Make devstack managing script executable.

   chmod +x devstack
   

   Copy

4. Create symlink to /usr/local/bin/devstack or to other bin path.

   ln -s ~/devstack /usr/local/bin/devstack
   

   Copy

⁠Configuration

⁠Ports

⁠Docker Compose (docker-compose.yml)

I have prepared docker configuration file for you. You can download it here⁠.

wget https://raw.githubusercontent.com/dockette/devstack/master/docker-compose.yml

If you didn't change the DEVSTACK_DOCKER variable, you should place your docker-compose.yml file to your user's folder ~/.devstack/docker-compose.yml.

After you've followed install section, your devstack should be well prepared. One thing left, you should configure your devstack (passwords, folders, etc).

You should:

• setup your data homeland⁠
• setup MySQL root password⁠
• setup PostgreSQL root password⁠

⁠Userdirs

There are two kind of users inside these containers, root (main unix user) and dfx (special user with uid 1000 in all dockette based images).

You can find it in docker-compose.yml file in section/container⁠.

On the containers startup, your users dir are attached to php72, php56, nodejs containers. You can create your own .bash_profile, .bashrc files for easier manipulation inside docker containers.

[TIP] There used to be a skeleton in ubuntu/debian/mint system.

cp /etc/skel/.bashrc <path-to-dfx-userdir>/.bashrc

⁠PHP

PHP container provides a few environment variables you can override:

⁠xdebug

⁠phpmailer

Phpmailer stores all mails send via mail() function to /srv/mail folder by default. You can change it.

⁠MySQL / MariaDB

MariaDB's default root password is root. You should change it.

You have to setup in you application/configs proper host which is mariadb.

MariaDB container has predefined IP address 172.10.10.20.

172.10.10.20 mariadb

⁠PostgreSQL

PostgreSQL's default root password is root. You should change it.

You have to setup in you application/configs proper host which is postgresql.

PostgreSQL container has predefined IP address 172.10.10.21. You could update your /etc/hosts.

172.10.10.21 postgresql

⁠Adminer

Adminer is great tool for managing database. Dockette devstack runs Adminer on port 8000.

See more on documentation at https://github.com/dockette/adminer⁠.

⁠Hosts

By default is devstack available on domains:

• localhost (php)
• local.dev (php)
• www.local.dev⁠ (php)
• local.dev7 (php7)
• www.local.dev7⁠ (php7)
• local.dev56 (php56)
• www.local.dev56⁠ (php56)

You should add these lines to your /etc/hosts file.

# Devstack [webserver]
127.0.0.1 local.dev
127.0.0.1 www.local.dev
127.0.0.1 local.dev7
127.0.0.1 www.local.dev7
127.0.0.1 local.dev56
127.0.0.1 www.local.dev56

# Devstack [DB]
172.10.10.20 mariadb
172.10.10.21 postgresql

Give a try!

ping local.dev
ping local.dev56
ping local.dev7
ping mariadb
ping postgresql

Thank you for testing, reporting and contributing.