xakra/s3browser repository overview

⁠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
   

   Copy

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>
   

   Copy

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
   

   Copy

⁠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.