OCTL

---

🌐 Links

• Documentation (this repo): docs/README.md
• OUTSCALE documentation: docs
• Releases: https://github.com/outscale/octl/releases
• Join our community on Discord

---

📄 Table of Contents

• 🌐 Links
• 🧭 Overview
• ✅ Requirements
• ⚙ Installation
• 🛠 Configuration
• 🚀 Quickstart
• 📚 Documentation
• 📜 License
• 🤝 Contributing

---

🧭 Overview

octl is a modern CLI for the Outscale APIs, written in Go.

It supports:

• installation via a single static binary,
• direct flags to all request fields (no JSON required),
• autocompletion support for all API calls, flags, and flag values,
• jq-style output filters,
• syntax highlighting of output,
• auto-update to the latest version.

It currently focuses on the IaaS API, but other OUTSCALE APIs are planned.

---

✅ Requirements

• Access to the OUTSCALE API (with appropriate credentials)

---

⚙ Installation

Download the latest binary from the Releases page.

Autocompletion setup is documented here:

• docs/installation.md

---

🛠 Configuration

Configuration can be provided either via environment variables or a profile file:

• docs/configuration.md

Quick example (env vars):

export OSC_ACCESS_KEY="..."
export OSC_SECRET_KEY="..."
export OSC_REGION="eu-west-2"

🚀 Quickstart

List volumes using the high-level command:

octl iaas volume list

Call an API operation directly:

octl iaas api ReadVms --Filters.VmStateNames running

More examples:

• docs/usage/overview.md
• docs/usage/iaas.md

📚 Documentation

• Start here: docs/README.md
• Installation + completion: docs/installation.md
• Configuration: docs/configuration.md
• Usage overview: docs/usage/overview.md
• Troubleshooting: docs/troubleshooting.md
• Command reference: docs/reference/commands.md

📜 License

octl is released under the BSD 3-Clause license.

© 2026 Outscale SAS

See LICENSE for full details.

🤝 Contributing

We welcome contributions!

Please read our Contributing Guidelines and Code of Conduct before submitting a pull request.