FTP Access

Oceanum Storage supports the FTP protocol for traditional file transfer operations. This is useful for tools and systems that don't support S3 but have FTP capabilities.

Connection Details

Setting	Value
Host	ftp.oceanum.io
Port	21 (standard FTP)
Protocol	FTP with TLS (FTPS)

Authentication

FTP access uses your organisation name and Datamesh token:

• Username: Your organisation name (e.g., my-org)
• Password: Your Datamesh token

To obtain your Datamesh token, see the Token documentation.

Command Line FTP

Using lftp (Recommended)

lftp provides a robust FTP client with scripting capabilities:

# Install lftp
# Ubuntu/Debian: sudo apt install lftp
# macOS: brew install lftp

# Connect (you will be prompted for password/token)
lftp -u my-org ftp.oceanum.io

# Or with explicit TLS
lftp -e "set ftp:ssl-force true" -u my-org ftp.oceanum.io

Common lftp commands:

# List files
ls

# Change directory
cd my-bucket/data

# Upload a file
put localfile.nc

# Download a file
get remotefile.nc

# Mirror a directory (upload)
mirror -R ./local-dir remote-dir

# Mirror a directory (download)
mirror remote-dir ./local-dir

# Exit
bye

Using curl

# List directory contents
curl -u my-org:$DATAMESH_TOKEN ftp://ftp.oceanum.io/

# Upload a file
curl -T localfile.nc -u my-org:$DATAMESH_TOKEN ftp://ftp.oceanum.io/my-bucket/data/

# Download a file
curl -u my-org:$DATAMESH_TOKEN ftp://ftp.oceanum.io/my-bucket/data/file.nc -o file.nc

FTP Clients

FileZilla

1. Open FileZilla
2. Go to File > Site Manager
3. Click New Site
4. Configure:
   • Host: ftp.oceanum.io
   • Port: 21
   • Protocol: FTP - File Transfer Protocol
   • Encryption: Require explicit FTP over TLS
   • Logon Type: Normal
   • User: Your organisation name
   • Password: Your Datamesh token
5. Click Connect

Cyberduck

1. Open Cyberduck
2. Click Open Connection
3. Select FTP-SSL (Explicit AUTH TLS)
4. Enter:
   • Server: ftp.oceanum.io
   • Username: Your organisation name
   • Password: Your Datamesh token
5. Click Connect

Scripting with FTP

For automated file transfers, you can create FTP scripts:

#!/bin/bash
# upload-data.sh

lftp -u $OCEANUM_ORG,$DATAMESH_TOKEN ftp.oceanum.io << EOF
cd my-bucket/data
put newdata.nc
bye
EOF

Or using a .netrc file for credentials:

# ~/.netrc
machine ftp.oceanum.io
login my-org
password your-datamesh-token

Then:

lftp ftp.oceanum.io -e "put file.nc; bye"

Limitations

Compared to the S3 API, FTP access has some limitations:

• No support for presigned URLs
• No multipart uploads (large files may be slower)
• Directory listing may be slower for buckets with many files
• No direct bucket creation (use the UI or S3 API)

For high-performance or programmatic access, consider using the S3 API instead.