Tutorials
Manage Static Website Hosting

Manage Static Website Hosting

This guide shows you how to create, test, enable/disable, update, and delete a Static Website attached to a bucket in AIOZ Storage. The flow is UI-only with no scripts required.

Step 1: Create a bucket

  1. Sign in to AIOZ Storage.
  2. Choose the Buckets tab.
  1. Choose New Bucket.
  1. Enter the Bucket name (for example, example.com).
  2. Save your bucket passphrase securely. AIOZ does not store passphrases. Without it, you cannot access your files.
  3. Tick “I understand, AIOZ Storage does not store any bucket passphrases. Without the passphrase, access to your files is not possible.”
  4. Choose Create Bucket.

Step 2: Create a Static Website for the bucket

Step 2.1: Select bucket & passphrase

  1. Select Bucket

    • Choose the bucket you want to create a static website configuration for.
  2. Enter Bucket Passphrase

    • Enter your bucket's passphrase.
  3. Click Next

Step 2.2: Configure website

  1. Enable Static Website
  1. Index Document

    • Default Index Document filename is index.html.

    • Or specify a custom filename.


    ⓘ Note
    For SPAs, serve Index Document for valid deep links so the client router renders the page.
  2. Error Document

    1. Use AIOZ default error page

      • The system serves a default error page with contextual messages.
    2. Use your Error Document

      • If an Error Document is set and default is off → the system serves that file.
  3. Per-status custom error pages

    • Add custom error pages for common HTTP status codes (400, 401, 500, 501...).
  4. Click Next

Step 2.3: Confirm

  1. Review the static website configuration.
  1. Choose Confirm to create a new static website.
  2. Return to the Static Websites page.

Step 3: Test your website endpoint

After creating a new static website configuration for a bucket, you can access your website via a mapped domain provided by AIOZ Storage (e.g., 'https://<bucket>.aiozstorage.network' ).


ⓘ Note
Reserve Error Document for true 404s. Test deep links directly.

Step 4: Manage static website configuration

  • View Static Websites
  • View static website details
  • Edit the static website configuration
    + Enable/Disable the static website
    + Update Index Document
    + Turn “Use default error page” On/Off
    + Add/remove per-status custom error pages
    + Delete static website configuration

Step 5: Clean up

Deleting the Static Website configuration

This action stops the Static Website but keeps the objects in the bucket.

  1. Choose Delete and enter the bucket’s passphrase
  1. Choose Delete Static Website

Deleting the bucket

This permanently removes the bucket, its objects, and the static website configuration. The Static Website becomes unavailable.


⚠️ Important
  • If a bucket is deleted, it can't be restored by AIOZ. Before deleting a bucket, make sure that you have backed up or replicated your data.

See also