Amazon S3 Directory Browser

Please report any issues here on GitHub.

Configuration

The app configures itself thanks to environment variables. The list of the supported variables are defined in the config file.

Installation with Apache

1. Check out the latest release from GitHub:

    cd /srv/www
    git clone [email protected]:powdahound/s3browser.git
   

2. Add an Apache VirtualHost for your new subdomain. e.g.:

    <VirtualHost *:80>
      ServerName s3browser.example.com
      DocumentRoot /srv/www/s3browser/www
   
      <Directory />
        AllowOverride all
        Order allow, deny
        Allow from all
      </Directory>
    </VirtualHost>
   

3. Tweak config to your liking. Each option is documented in the config.php file. Since it defaults to loading the values from environment variables, using SetEnv is probably best. You could also edit config.php to your liking.

4. Reload your Apache config:

    sudo /etc/init.d/apache2 reload
   

Docker integration

1. Create a .env file with the configuration needed
2. Install docker-compose
3. Run docker-compose up --build

Give a look at the Dockerfile and docker-compose.yml if needed.