PHPackages                             innmind/ark - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. innmind/ark

AbandonedLibrary[DevOps & Deployment](/categories/devops)

innmind/ark
===========

Servers' array management

3.1.0(5y ago)019MITPHPPHP ~7.4|~8.0

Since Mar 24Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/Innmind/Ark)[ Packagist](https://packagist.org/packages/innmind/ark)[ Docs](http://github.com/Innmind/Ark)[ RSS](/packages/innmind-ark/feed)WikiDiscussions develop Synced 4d ago

READMEChangelogDependencies (11)Versions (9)Used By (0)

Ark
===

[](#ark)

[![Build Status](https://github.com/Innmind/Ark/workflows/CI/badge.svg?branch=master)](https://github.com/Innmind/Ark/actions?query=workflow%3ACI)[![codecov](https://camo.githubusercontent.com/937da3e46bc4224d547dfc0edddb1fcc2311daa546911753267f01086706ad31/68747470733a2f2f636f6465636f762e696f2f67682f496e6e6d696e642f41726b2f6272616e63682f646576656c6f702f67726170682f62616467652e737667)](https://codecov.io/gh/Innmind/Ark)[![Type Coverage](https://camo.githubusercontent.com/6b61f2dd0854595ff06dfda3822ddd5b192d5acb2442548df154209418cdb76a/68747470733a2f2f73686570686572642e6465762f6769746875622f496e6e6d696e642f41726b2f636f7665726167652e737667)](https://shepherd.dev/github/Innmind/Ark)

The ark is a simple tool to spinup new servers and trash the ones in service in your infrastructure.

It works with the [Ovh](https://ovh.com) api and uses the vps endpoints or with [Scaleway](https://www.scaleway.com/).

Only the installation provided by the ark array can be asked to be disposed.

### Ovh implementation detail

[](#ovh-implementation-detail)

Since it's not possible to order new servers via the Ovh api this library rely on the state of your servers.

If a server is stopped it considers that it is available when asking for a new server. When a server is chosen as a new server it will reinstall the server with a [template id](https://eu.api.ovh.com/console/#/vps/%7BserviceName%7D/templates#GET) that you must provide, the only way to connect to the server will be via a ssh key (no password is generated as we couldn't automate the reinstallation).

With ovh disposing a server simply means it will stop the server (allowing it to be considered as available when asking for a new server).

Installation
------------

[](#installation)

```
composer require innmind/ark
```

Usage
-----

[](#usage)

### Scaleway

[](#scaleway)

```
use function Innmind\Ark\scaleway;
use function Innmind\ScalewaySdk\bootstrap as sdk;
use Innmind\OperatingSystem\Factory;
use Innmind\ScalewaySdk\{
    Token,
    Region,
    User,
    Organization,
    Image,
};
use Innmind\SshKeyProvider\Local;
use Innmind\Url\Path;

$os = Factory::build();
$sdk = sdk($os->remote()->http(), $os->clock());
$scaleway = $sdk->autnenticated(new Token\Id('uuid')); // create an api token at https://console.scaleway.com/account/credentials

$ark = scaleway(
    $scaleway->servers(Region::paris1()),
    $scaleway->ips(Region::paris1()),
    $scaleway->users(),
    $os->process(),
    new Local(
        $os->control()->processes(),
        Path::of('/home/{serverUser}/.ssh'),
    ),
    new User\Id('your user uuid'),
    new Organization\Id('the organization uuid you want to create servers in'),
    new Image\Id('the image uuid you want to build'),
);

$installation = $ark->forge()->new();
$installAppOn($installation->location());
$ark->array(); // will contain the new server now
```

### Ovh

[](#ovh)

The very first step is to buy vps servers from [ovh](https://www.ovh.com/fr/vps/), then you can start writing this kind of code:

```
use function Innmind\Ark\ovh;
use Innmind\OperatingSystem\Factory;
use Innmind\SshKeyProvider\Local;
use Innmind\Url\Path;
use Ovh\Api;

$os = Factory::build();

$ark = ovh(
    new Api(/* args */),
    new Local(
        $os->control()->processes(),
        Path::of('/home/{serverUser}/.ssh'),
    ),
    $os,
);

$installation = $ark->forge()->new();
$installAppOn($installation->location());
$ark->array(); // will contain the new server now
```

You can refer to the [ovh documentation](https://api.ovh.com/g934.first_step_with_api) to know how you can generate the tokens needed to build the `Api` object.

**Important**: you need to generate the consumer key yourself as it can't be automated. The library requires the following access rights in order to work properly: `POST`, `DELETE`, `GET` and `POST`.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance55

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity73

Established project with proven stability

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~176 days

Recently: every ~257 days

Total

7

Last Release

1917d ago

Major Versions

1.3.0 → 2.0.02019-04-21

2.0.0 → 3.0.02020-03-01

PHP version history (3 changes)1.0.0PHP ~7.2

3.0.0PHP ~7.4

3.1.0PHP ~7.4|~8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/851425?v=4)[Baptiste Langlade](/maintainers/Baptouuuu)[@Baptouuuu](https://github.com/Baptouuuu)

---

Tags

servermanagement

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/innmind-ark/health.svg)

```
[![Health](https://phpackages.com/badges/innmind-ark/health.svg)](https://phpackages.com/packages/innmind-ark)
```

###  Alternatives

[spatie/laravel-webhook-server

Send webhooks in Laravel apps

1.1k8.8M22](/packages/spatie-laravel-webhook-server)[pragmarx/health

Laravel Server & App Health Monitor and Notifier

2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[clue/socket-raw

Simple and lightweight OOP wrapper for PHP's low-level sockets extension (ext-sockets).

35111.1M48](/packages/clue-socket-raw)[voryx/thruway

Thruway WAMP router core

6771.0M17](/packages/voryx-thruway)[php-mcp/server

PHP SDK for building Model Context Protocol (MCP) servers - Create MCP tools, resources, and prompts

828280.5k25](/packages/php-mcp-server)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)