Akamai Object Storage, formerly Linode Object Storage, is an S3-compatible object storage service on Akamai's cloud computing platform. Buckets live in a region and are reached through an S3 endpoint such as us-east-1.linodeobjects.com.
How does the integration work?
By default, self-hosted Appwrite Storage keeps uploaded files on your server's local disk. The linode storage adapter, named after the service's former brand, stores them in an Akamai Object Storage bucket instead, so file storage scales separately from your server and survives a server rebuild. Appwrite builds the bucket address, <bucket>.<region>.linodeobjects.com, from the bucket name and region you configure.
Storage adapters configure a self-hosted Appwrite instance. Appwrite Cloud manages file storage for you.
How to implement
To store Appwrite files in Akamai Object Storage, there are several steps you must complete:
Step 1: Create a bucket and an access key
In Akamai Cloud Manager, create an Object Storage bucket in the region closest to your Appwrite server. Note the bucket name and the region ID at the start of its S3 endpoint, for example us-east-1 from us-east-1.linodeobjects.com or us-iad-10 from us-iad-10.linodeobjects.com.
Then create an access key with read and write access to the bucket. Save the access key and secret key. Cloud Manager shows the secret key only once.
Step 2: Configure the Akamai adapter in Appwrite
For this step, you must self-host Appwrite if you haven't already.
Open the .env file of your Appwrite installation and set the storage variables:
_APP_STORAGE_DEVICE=linode_APP_STORAGE_S3_ACCESS_KEY=<ACCESS_KEY>_APP_STORAGE_S3_SECRET=<SECRET_KEY>_APP_STORAGE_S3_REGION=us-east-1_APP_STORAGE_S3_BUCKET=<BUCKET_NAME>_APP_STORAGE_DEVICE=linode selects the Akamai Object Storage adapter, and the _APP_STORAGE_S3_* variables hold its credentials, region, and bucket.
Older installations set _APP_STORAGE_LINODE_ACCESS_KEY, _APP_STORAGE_LINODE_SECRET, _APP_STORAGE_LINODE_REGION, and _APP_STORAGE_LINODE_BUCKET. Appwrite 2.0 and later still read them as a fallback when _APP_STORAGE_S3_ACCESS_KEY, _APP_STORAGE_S3_SECRET, and _APP_STORAGE_S3_BUCKET are not all set, but they are deprecated, and the Open Runtimes orchestrator that builds Functions and Sites doesn't read them. Move the values to the _APP_STORAGE_S3_* variables.
Recreate the containers and check that the variables are applied:
docker compose up -ddocker compose exec appwrite varsChanging the storage device doesn't move files Appwrite has already stored, so configure it before you store production files.
Step 3: Test the adapter
Open your project in the Appwrite Console, go to Storage, create a bucket, and upload a file. The file then appears in your bucket in Akamai Cloud Manager.
Read more about Akamai Object Storage and Appwrite Storage
If you would like to learn more about Akamai Object Storage and Appwrite Storage, we have some resources that you should visit:
