Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions storage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,26 @@
title: Object Storage
---

Welcome to the [Gcore Object Storage](https://gcore.com/storage) documentation page! Here we explain how to use, configure, and troubleshoot Gcore Object Storage.
Gcore Object Storage is an S3-compatible service for storing media files, logs, backups, AI/ML datasets, and other data types.

Check warning on line 5 in storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage.mdx#L5

Did you really mean 'Gcore'?

Gcore Object Storage is an S3 or SFTP service that lets you store various types of data (media files, logs, backups, etc.) on Gcore's digital data storage hardware.
## Storage types

From the left-side menu, you can access in-depth documentation about Gcore Object Storage:
| Type | Performance | Best for |
|------|-------------|----------|
| **S3 Fast** | 5-6 ms TTFB, up to 27x faster on small files | AI/ML workloads, IoT telemetry, latency-sensitive applications |
| **S3 Standard** | 200+ ms TTFB | General-purpose storage, backups, content delivery |

S3 Fast is available in Sines-2, Sines-3 (Portugal), and London-2 (UK), co-located with Gcore GPU infrastructure.

Check warning on line 14 in storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage.mdx#L14

Did you really mean 'Gcore'?

## Documentation

From the left-side menu, access in-depth documentation:

* **Create Object Storage** – create Object Storage or SFTP storage
* **Billing** – tariff plans, limits, billing rules
* **Use Object Storage with CDN** – assign storage to a CDN resource origin, how the file requesting scheme works with a CDN
* **Manage Object Storage** – manage buckets, control file visibility
* **Manage SFTP storage** – connect to your storage using FileZilla, manage SSH keys in the Gcore Customer Portal

Check warning on line 24 in storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage.mdx#L24

Did you really mean 'Gcore'?
* **Request files from Object Storage** – scheme for requesting uploaded files
* **View statistics** – used space, number of requests, traffic
* **Troubleshooting** – resolve any 403 and 404 storage issues
Expand Down
46 changes: 31 additions & 15 deletions storage/create-an-s3-or-sftp-storage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,38 +3,54 @@
sidebarTitle: Create Object Storage
---

## Create a storage

To create a storage:
## Storage types

1. In the Gcore Customer Portal, click **Add new storage** in the top-right corner of the screen.
2. Specify the storage name and location. The location name has two elements: the storage type (Object Storage or SFTP) and the city/region where the data center is located. SFTP locations are added/removed from the list automatically depending on the amount of free storage space available.
Gcore Object Storage is available in two performance tiers:

Check warning on line 8 in storage/create-an-s3-or-sftp-storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/create-an-s3-or-sftp-storage.mdx#L8

Did you really mean 'Gcore'?

| Type | Best for | Performance |
|------|----------|-------------|
| **S3 Fast** | AI/ML training datasets, embeddings, IoT telemetry, small-file workloads | 5-6 ms TTFB, up to 27x faster on small files |
| **S3 Standard** | General-purpose storage, backups, content delivery | 200+ ms TTFB |

The storage type is determined by the location selected during creation. Locations prefixed with "S3 Fast" provide high-performance storage, while "S3 Standard" locations provide general-purpose storage.

Please note: You can create a maximum of 3600 storages per account.
### S3 Fast performance

### Object storage
S3 Fast delivers consistent, high-throughput performance optimized for small-file and latency-sensitive workloads:

Please note two limits for Object Storage:
- **Small files**: Up to 27x faster throughput (~1,350 objects/second) compared to Standard
- **Mixed workloads**: 2.2x faster than Standard
- **Large files**: 1.9x faster than Standard (advantage depends on client proximity)

1. You can create a maximum of 1000 buckets.
2. You can place maximum 10M objects in one bucket. However, we recommend placing no more than 100K objects so storage performance and availability are higher. If you want to place more than 100K objects, we recommend storing them in different buckets.
<Info>
S3 Fast storage is available in Sines-2, Sines-3 (Portugal), and London-2 (UK). These locations are co-located with Gcore GPU infrastructure, making them ideal for AI/ML pipelines.

Check warning on line 26 in storage/create-an-s3-or-sftp-storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/create-an-s3-or-sftp-storage.mdx#L26

Did you really mean 'Gcore'?
</Info>

## Create a storage

To create a storage:

To create an Object Storage, specify its name and location, and click the **Create** button.
1. In the Gcore Customer Portal, navigate to **Object Storage** and click **Add new object storage**.

Check warning on line 33 in storage/create-an-s3-or-sftp-storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/create-an-s3-or-sftp-storage.mdx#L33

Did you really mean 'Gcore'?
2. Enter a storage name.
3. Select a location. The location determines the storage type (Fast or Standard) and the data center region.
4. Click **Create**.

In the next window, you will see both access and secret keys. Copy and save them since you'll see the keys only once.
After creation, the access key and secret key are displayed. Copy and save these credentials immediately as they are shown only once.

<Warning>
Maximum 3600 storages can be created per account.

Check warning on line 41 in storage/create-an-s3-or-sftp-storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/create-an-s3-or-sftp-storage.mdx#L41

Did you really mean 'storages'?
</Warning>

<Frame>![Create a storage](/images/docs/storage/create-storage/s3-storage-created-10.png)</Frame>
### Object storage limits

Object Storage has the following limits:

- Maximum 1000 buckets per storage
- Maximum 10 million objects per bucket (for optimal performance, keep under 100K objects per bucket and distribute across multiple buckets)

The created storage will appear in the storage list.
<Frame>![Create a storage](/images/docs/storage/create-storage/s3-storage-created-10.png)</Frame>

To see its information (location, hostname), click the **Details** button.
The created storage appears in the storage list. Click **Details** to view location and hostname information.

Check warning on line 53 in storage/create-an-s3-or-sftp-storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/create-an-s3-or-sftp-storage.mdx#L53

Did you really mean 'hostname'?

If you have forgotten to copy the keys and want to change them, click the **Generate new keys** button.

Expand All @@ -54,7 +70,7 @@



To see the hostname, click the **Details** button (use port 2200 to connect to the storage).

Check warning on line 73 in storage/create-an-s3-or-sftp-storage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/create-an-s3-or-sftp-storage.mdx#L73

Did you really mean 'hostname'?

Password can be set, removed, and updated. To add new keys (up to 5 per storage) or limit access to the uploaded ones go to the SSH keys manager.

Expand Down
38 changes: 31 additions & 7 deletions storage/how-storage-is-billed.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,27 +3,51 @@
sidebarTitle: Billing
---

## Plans and billing rules
## Storage types and pricing

Prices and plans are described on the [website](https://gcore.com/pricing/storage).
Gcore Object Storage is available in two performance tiers with different pricing:

Check warning on line 8 in storage/how-storage-is-billed.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/how-storage-is-billed.mdx#L8

Did you really mean 'Gcore'?

The plan subscription fee and the traffic overcommitment fee are charged on the 2nd day of each month. If the payment fails, the service will be stopped.
### S3 Standard

Additional features are charged at the beginning of the month.
General-purpose storage for most workloads.

| Item | Price (EUR) | Price (USD) |
|------|-------------|-------------|
| Storage | €0.04/GB/month | $0.044/GB/month |
| Egress | €0.02/GB | $0.022/GB |
| Ingress | Free | Free |
| Requests | €0.03/10K | $0.033/10K |

### S3 Fast

High-performance storage optimized for AI/ML workloads, IoT telemetry, and latency-sensitive applications. Available in Sines-2, Sines-3, and London-2.

<Frame>![Plans and billing rules](/images/docs/storage/billing/storage-tariffs-10.jpg)</Frame>
| Item | Price (EUR) | Price (USD) |
|------|-------------|-------------|
| Storage | €0.06364/GiB/month | $0.07/GiB/month |
| Egress | €0.0013/GB | $0.00143/GB |
| Ingress | Free | Free |
| Requests | €0.03/10K | $0.033/10K |

<Info>
Current pricing and plan details are available on the [pricing page](https://gcore.com/pricing/storage).
</Info>

## Billing rules

The plan subscription fee and the traffic overcommitment fee are charged on the 2nd day of each month. If the payment fails, the service will be stopped.

Additional features are charged at the beginning of the month.

## Change your plan

Navigate to the Profile icon in the lower-left corner of the page, choose Billing, and change the plan you need.

The new plan will be applied on the 1st day of the next month.

If you have any questions, please, contact us via chat or email ([support@gcore.com](mailto:support@gcore.com)).
If you have any questions, contact support via chat or email at [support@gcore.com](mailto:support@gcore.com).

## Object storage limits

1\. You can create maximum 1000 buckets. 2\. You can place a maximum of 10 million objects in one bucket.
- Maximum 1000 buckets per storage
- Maximum 10 million objects per bucket
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,34 @@
sidebarTitle: S3 service URLs and default region names
---

You can utilize any software compatible with S3 API to work with Gcore Object Storage.
Gcore Object Storage is compatible with any S3-compatible software. Use the service URLs and default region names listed below to connect and perform operations.

Check warning on line 6 in storage/manage-object-storage/s3-service-urls-and-default-region-names.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/manage-object-storage/s3-service-urls-and-default-region-names.mdx#L6

Did you really mean 'Gcore'?

To connect to your storage or carry out any operation, it is recommended that you use the service URLs and default region names.
## Storage types

Please refer to the table below for the appropriate values.
Gcore offers two S3-compatible storage types:

Check warning on line 10 in storage/manage-object-storage/s3-service-urls-and-default-region-names.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/manage-object-storage/s3-service-urls-and-default-region-names.mdx#L10

Did you really mean 'Gcore'?

Storage location | Default region name | Endpoint (service URL)
---|---|---
S3 Luxembourg | s-ed1 | s-ed1.cloud.gcore.lu
S3 Chicago | s-drc2 | s-drc2.cloud.gcore.lu
S3 Singapore | s-sgc1 | s-sgc1.cloud.gcore.lu
- **S3 Standard**: General-purpose storage for most workloads. Suitable for static assets, backups, and content delivery.
- **S3 Fast**: High-performance storage optimized for AI/ML workloads, small-file operations, and latency-sensitive applications. Delivers single-digit millisecond time-to-first-byte (TTFB) and up to 27x faster throughput on small files compared to Standard storage.

The storage type is determined by the location selected during creation.

## Service URLs and region names

### S3 Fast locations

| Storage location | Default region name | Endpoint (service URL) |
|---|---|---|
| S3 Fast Sines-2 | s-ndp1-2 | sines-2.storage.gcore.dev |
| S3 Fast Sines-3 | s-ndp1-3 | sines-3.storage.gcore.dev |
| S3 Fast London-2 | s-ndlo-2 | london-2.storage.gcore.dev |

### S3 Standard locations

| Storage location | Default region name | Endpoint (service URL) |
|---|---|---|
| S3 Standard Luxembourg-2 | s-ed1 | luxembourg-2.storage.gcore.dev |
| S3 Standard Chicago | s-drc2 | chicago-1.storage.gcore.dev |

<Info>
S3 Fast storage is available in locations with Gcore GPU infrastructure, making it ideal for AI/ML pipelines that require high-throughput data access.

Check warning on line 35 in storage/manage-object-storage/s3-service-urls-and-default-region-names.mdx

View check run for this annotation

Mintlify / Mintlify Validation (gcore) - vale-spellcheck

storage/manage-object-storage/s3-service-urls-and-default-region-names.mdx#L35

Did you really mean 'Gcore'?
</Info>
Loading