Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save harshavardhana/f05b60fe6f96803743f38bea4b565bbf to your computer and use it in GitHub Desktop.
Save harshavardhana/f05b60fe6f96803743f38bea4b565bbf to your computer and use it in GitHub Desktop.
How to configure static website using Nginx with MinIO ?

How to configure static website using Nginx with MinIO ?

1. Install nginx

2. Install minio

3. Install mc client

4. Create a bucket:

$ mc mb myminio/static
Bucket created successfully ‘myminio/static’.

5. Make bucket public to host/access static content.

$ mc anonymous download myminio/static
Access permission for ‘myminio/static’ is set to ‘download’

6. Upload a sample static HTML site to minio bucket, in my case i used example: http://www.oswd.org/user/profile/id/12362/

$ mc cp -r terrafirma/ myminio/static
...ma/readme.txt:  39.37 KB / 39.37 KB ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 100.00% 31.94 KB/s 1s

Note: this is how my bucket content appears to me currently.

$ mc ls myminio/static
[2017-03-22 18:20:52 IST] 4.7KiB default.css
[2017-03-22 18:20:54 IST] 5.4KiB index.html
[2017-03-22 18:20:54 IST]   612B readme.txt
[2017-03-22 18:24:03 IST]     0B images/

7. Configure Nginx as proxy to serve static pages from public bucket name static from Minio.

Remove default configuration and replace it with the below. Please change as per your local setup.

$ cat /etc/nginx/sites-enabled/default 
server {
 listen 80;
 server_name localhost;
 location / {
   rewrite ^/$ /static/index.html break;
   proxy_set_header Host $http_host;
   proxy_pass http://localhost:9000/static/;
 }
}

$ sudo service nginx reload

8. Open your browser and type http://localhost

@vincib
Copy link

vincib commented Nov 25, 2022

Hi @harshavardhana,

The error page of minio will be served as default; do you know about how to specific a file to be a custom error page (like 404).

add this:

proxy_intercept_errors on;
error_page      400 401 402 403 404 500 501 502 503 504 /static/yourerrorpage.html;

you may also replace /static/errorpage.html by a @namedlocation and use a specific location to handle those.

@almereyda
Copy link

There is now also an officially supported Nginx example with S3 backend upstream available at:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment