CDN
CDN
Keep the city's images, videos and sounds on a fast link for the inventory, the dealership, the loading screen and script screenshots.
Keep the city's images, videos and sounds on a fast link for the inventory, the dealership, the loading screen and script screenshots.
The CDN is the city’s warehouse: one place for the images, videos and sounds the server uses, each file with a fast link. Inventory icons, dealership photos, loading screen backgrounds and the screenshots scripts send from the game live here, with no more Imgur going down or Discord links expiring. This page is for the owner and the staff who handle the server’s files.
In CDN → Files, while the CDN doesn’t exist, you see …‘s CDN hasn’t been created yet. Click Create the CDN and follow the three steps of Keep the city’s media in one place.
In CDN address, type the address (the default is my-city). FiveDash shows Available or In use. Click Continue.
Tick the folders the city uses (list below). Adjust Optimize images (the WebP quality) and, if you want, turn on Start with sample files. Click Create … folders, or Start without folders.
Pick the Destination folder and drag images, videos and audio into the upload area (or choose from your computer). Every file gets a link right away. Click Open the CDN.
| Folder | Name in the link | What it’s for | Ticked by default |
|---|---|---|---|
| Inventory | itens | Item icons, for ox_inventory and the like | Yes |
| Vehicles | veiculos | Dealership and garage photos | Yes |
| Loading screen | loading-screen | Backgrounds, logo and trailer | Yes |
| Screenshots | screenshots | Screenshots scripts send from the game | Yes |
| Logos and banners | marca | Logo, Discord and store banners | No |
| Clothing | roupas | Clothing and accessory previews | No |
| Clips | clipes | Event and promo videos | No |
| Sounds | sons | Effects and music for xsound and interact-sound | No |
Every file has a public link in this format:
https://cdn.fivex.sh/<address>/<folder>/<file>
For example: https://cdn.fivex.sh/example-city/itens/agua.png. Subfolders go in the path. On the Ultra plan, a domain of the city’s can serve the same files (see Custom domain).
| Address rule | Value |
|---|---|
| Length | 3 to 32 characters |
| Characters | Lowercase letters, numbers and hyphens, no hyphen at either end |
| Reserved | admin, api, cdn, assets, fivex, fivedash, static, health, internal, uploads |
| Unique | Can’t belong to another city (“That address belongs to another city. Try another one.”) |
| Type | Formats |
|---|---|
| Images | PNG, JPEG, WebP, GIF, SVG |
| Videos | MP4, WebM, MOV |
| Audio | MP3, OGG, WAV, M4A |
Any other file is rejected on upload. PNG, JPEG and WebP can be optimized into WebP; GIF, SVG, audio and video are served as uploaded.
| Page | Path in the panel | What it does |
|---|---|---|
| Files | CDN → Files | Folders, uploads, search, preview, links, favorites and trash. |
| Usage | CDN → Usage | Storage, traffic, hits, the month’s allowances and most accessed files. |
| Settings | CDN → Settings | Address, custom domain, images, retention, uploads, protection, cache, upload keys and danger zone. |
CDN → Settings holds how the CDN serves, stores and protects the files. Address, images, retention, uploads, protection and cache are saved together from the Save bar. Upload keys and Delete the CDN apply right away. With Settings at View only, the page shows “Your access lets you view, not change.”
| Section | Field | What it does | Default |
|---|---|---|---|
| Address | Public address | The start of every link: cdn.fivex.sh/<address>. Once a new address is saved, the old links stop working. | The one chosen at creation |
| Custom domain | Subdomain | A subdomain of the city’s to serve the files (Ultra). See Custom domain. | None |
| Images | Optimize images | The WebP quality, from 70% to 100%. At 100% (Original) it keeps the uploaded format. | 85% |
| Images | Max width | Larger images are scaled down on upload: No limit, 1920 px, 2560 px or 3840 px (4K). | 2560 px |
| Images | Remove metadata | Strips location and camera data from photos before publishing. | On |
| Retention | Images, Videos, Audio | Automatically deletes what gets old: Keep forever, 7, 14, 30, 60, 90, 180 days or 1 year. Everything goes to the trash first and is gone for good after 30 days. | Keep forever |
| Retention | Favorites | Starred files stay, however old. | On |
| Retention | Protected folders | Folders (with everything inside) that retention never deletes. | None |
| Uploads | Max size per file | The largest audio or video the team can upload from the panel: 25, 50, 100 or 250 MiB. Images go up to 20 MiB; the scripts API, up to 20 MiB. | 100 MiB |
| Uploads | Accepted formats | The list of accepted formats (read-only). | — |
| Protection | Only the city uses the files | Stops other sites from displaying your files (and using up your traffic). The game, the NUI and the loading screen can always use them. | Off |
| Protection | Allowed sites | Domains that can also display the files, like store.yourcity.com or *.yourcity.com. Click Allow to add one. Up to 50. | None |
| Cache | Cache time | How long the CDN keeps copies: 1 day, 7 days, 30 days or 1 year. Purge cache makes everyone see the new version of a file replaced under the same name. | 30 days |
| Upload keys | New key | Keys for scripts that upload files on their own. See Upload keys. | None |
| Danger zone | Delete the CDN | Takes down every file, folder, key and the address, and goes back to the initial setup. | — |
Access is given in Settings → Members, CDN module.
| Area | Level | What it allows |
|---|---|---|
| Files | View | See files and copy links |
| Files | Manage | Upload, rename, move and send to the trash (and create the CDN) |
| Files | Configure | Also delete forever and empty the trash |
| Usage | View | Storage, traffic and most accessed files |
| Settings | View | Address, optimization and upload keys |
| Settings | Configure | Change optimization and protection, and create keys |
Are the files private? No. CDN links are public: anyone with the link opens the file. The Only the city uses the files option (in CDN → Settings → Protection) stops other sites from displaying your files, but the link stays public.
Can scripts that take screenshots use the CDN? Yes. Create an upload key and use it in screenshot-basic or over HTTP. See Upload keys and Integrations.
How do I delete the whole CDN? In CDN → Settings → Danger zone, click Delete the CDN and confirm with Delete everything. Every file, folder, key and the address go offline right away. This can’t be undone. It needs Configure on both Files and Settings.